Add OpenTelemetry Javaagent framework - #1020

Could you also share an example user-provided-service command with sample required config?

Should I remove (cups) too? It won't match the abbreviation now.

Maybe you could just change 'provide' to 'create', because cups is the short command for create-user-provided-service 😅

Note: this may be less relevant when CF has a collector bundled in the image VM, right?

I updated this section a bit.

Reading the docs as they are currently, it seems a user would need to look up the properties required to connect the agent to a collector, which I think is required for this integration to be useable in this initial offering.

Therefore I was hoping to have a complete example of how to add the agent to an app, which gets config properties from the binding, and sends data to a user-defined collector. I think the last part is all that's left. I can then test the steps in my env, as a user.

Please let me know if I'm not correct about how this should work!

@nrekretep I'm not a cloudfoundry user, so I could use your assistance. I'm not sure how to respond to David's request here. Do you think you could chime in with a more authoritative response?

If understanding correctly then the docs should contain a complete example of the necessary configuration for the user provided otel-collector service.

What needs to be added to the docs depends on which exporters and which protocol you want to use to send data to the collector.

Lets assume you want to just use the otlp exporter over grpc for metrics and traces and the collector endpoint uses tls and basic auth.

From my understanding the following properties need to be added to the user provided service:

{
  "otel.exporter.otlp.endpoint" : "https://my-collector-endpoint",
  "otel.exporter.otlp.headers" : "authorization=Basic SOMEBAS64STRING",
  "otel.exporter.otlp.protocol" : "grpc",
  "otel.metrics.exporter" : "otlp",
  "otel.traces.exporter" : "otlp",
}

We use this setup in CF, but we configure the otel agent via environment variables. Setting the java system properties as above should work, too.

Maybe adding a link to the complete set of configuration options for the java agent would help, too.

HTH

This would be ideal @nrekretep - an example of basic/minimum config required for the user-service along with a link to the full options available.

@tylerbenson are you ok to add this to the docs part of your PR? Alternatively I could add this separately.

We're aiming to get this merged and into a release next week.

@pivotal-david-osullivan I would really appreciate if you could take this over. Thanks!